home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.lha / man / newsmaint.man < prev    next >
Text File  |  1994-01-04  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4. NEWSMAINT(8)                                         NEWSMAINT(8)
  5.  
  6.  
  7. ›1mNAME›22m
  8.        newshist - extract history line for news article(s)
  9.        newsdaily - maintain news log files and report problems
  10.        newswatch - keep an eye on news system for difficulties
  11.        newsboot - clean up news debris on reboot
  12.        locknews - lock news system for manual tinkering
  13.        addgroup,  delgroup  -  add and delete newsgroups, locally
  14.        only
  15.        adddirs - make any missing directories  for  active  news­
  16.        groups
  17.        addfeed - add a news feed
  18.        act.to.times - create active.times file for news readers
  19.        histfrom, newsfrom - list news arriving over specific time
  20.        range
  21.        addmissing - add missing news articles to history file
  22.  
  23. ›1mSYNOPSIS›22m
  24.        ›1m/usr/lib/newsbin/maint/newshist›22m msgid ...
  25.        ›1m/usr/lib/newsbin/maint/newsdaily›22m [ guru ... ]
  26.        ›1m/usr/lib/newsbin/maint/newswatch›22m [ guru ... ]
  27.        ›1m/usr/lib/newsbin/maint/newsboot›22m
  28.        ›1m/usr/lib/newsbin/maint/locknews›22m
  29.        ›1m/usr/lib/newsbin/maint/addgroup›22m group {›1my›22m|›1mn›22m|›1mm›22m|›1mx›22m|›1m=›4m›22mrealgroup›24m}
  30.        ›1m/usr/lib/newsbin/maint/delgroup›22m group
  31.        ›1m/usr/lib/newsbin/maint/adddirs›22m
  32.        ›1m/usr/lib/newsbin/maint/addfeed›22m [ ›1m-L›22m ] site groups
  33.        ›1m/usr/lib/newsbin/maint/act.to.times›22m activefile
  34.        ›1m/usr/lib/newsbin/maint/histfrom›22m startdate [ enddate ]
  35.        ›1m/usr/lib/newsbin/maint/newsfrom›22m startdate [ enddate ]
  36.        ›1m/usr/lib/newsbin/maint/addmissing›22m
  37.  
  38. ›1mDESCRIPTION›22m
  39.        These  programs  are  utilities  useful in maintaining a C
  40.        News system and diagnosing problems in it.
  41.  
  42.        ›4mNewshist›24m prints the history line for each article  identi­
  43.        fied by a ›4mmsgid›24m.
  44.  
  45.        ›4mNewsdaily›24m performs minor maintenance chores that typically
  46.        should be done once a day  for  the  news  system:  saving
  47.        copies  of log files and truncating them, reporting logged
  48.        errors, checking for  anomalies  suggesting  something  is
  49.        wrong,  and  cleaning out leftover files.  ›4mNewsdaily›24m saves
  50.        one generation of old ›4mlog›24m files and three  generations  of
  51.        old ›4merrlog›24m and ›4mbatchlog›24m files.  It reports problems to the
  52.        named ›4mguru›24ms (default:  `usenet').
  53.  
  54.        ›4mNewswatch›24m looks for indications  of  news  problems  on  a
  55.        shorter  time  scale  than  those  reported  by ›4mnewsdaily›24m,
  56.        notably strangely­persistent lock files that may  indicate
  57.        a  news­system  failure.  It typically should be run a few
  58.        times a day.
  59.  
  60.        ›4mNewsboot›24m should  be  run  from  ›4m/etc/rc›24m  or  the  system's
  61.  
  62.  
  63.  
  64.                            13 Oct 1990                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NEWSMAINT(8)                                         NEWSMAINT(8)
  71.  
  72.  
  73.        equivalent  on  reboot.   It cleans up files that the news
  74.        system might have left lying about if the  system  crashed
  75.        while news was being processed, notably old lock files.
  76.  
  77.        ›4mLocknews›24m  locks the news system, starts up a shell for the
  78.        user, and waits around to unlock the news system when that
  79.        shell terminates.  This simplifies manual maintenance.
  80.  
  81.        ›4mAddgroup›24m and ›4mdelgroup›24m respectively add a newsgroup (with a
  82.        specified flags field for the ›4mactive›24m  file,  normally  `y'
  83.        [see  ›4mnews›24m(5)])  and  delete  a  newsgroup  manually, with
  84.        proper locking.  The effect is purely  local;  no  control
  85.        message  (to  propagate  the  change to other machines) is
  86.        sent.
  87.  
  88.        ›4mAdddirs›24m sweeps  through  the  ›4mactive›24m  file  checking  that
  89.        directories  exist  for  all  newsgroups.  (›4mRelaynews›24m will
  90.        create directories  as  needed,  but  some  user­interface
  91.        software  gets  upset if a newsgroup exists but its direc­
  92.        tory does not.)  This is mostly useful when adding  groups
  93.        in bulk, based on another site's ›4mactive›24m file.
  94.  
  95.        ›4mAddfeed›24m  adds  a  line to the ›4msys›24m file specifying that the
  96.        ›4msite›24m should be fed the ›4mgroups›24m, and creates a suitable out­
  97.        bound­batching  directory.  If the ›1m-L›22m option is given, the
  98.        ›1mL›22m flag is  included  to  restrict  the  feed  to  locally­
  99.        generated  articles  only.   If  ›4mgroups›24m does not include a
  100.        distribution list (separated  from  the  newsgroups  by  a
  101.        `/'),  the  default  distribution list `/all' is appended.
  102.        If ›4mgroups›24m is of the form ›1m=›4m›22mname›24m, this  specifies  the  same
  103.        groups  as  those  fed  to site `›4mname›24m', with the exception
  104.        that `to.›4mname›24m' is rewritten to `to.›4msite›24m'.
  105.  
  106.        ›4mAct.to.times›24m emits (on standard output) a new ›4mactive.times›24m
  107.        file  (see  ›4mactive.times›24m(5))  based  on  the  contents  of
  108.        ›4mactivefile›24m, which should normally be ›4m/usr/lib/news/active›24m.
  109.  
  110.        ›4mHistfrom›24m  emits (on standard output) all history lines for
  111.        unexpired articles arriving between ›4mstartdate›24m and ›4menddate›24m.
  112.        The  dates must be acceptable to ›4mgetdate›24m (see ›4mnewsaux›24m(8)).
  113.        The default ›4menddate›24m is ``now''.
  114.  
  115.        ›4mNewsfrom›24m runs ›4mhistfrom›24m and processes its output to produce
  116.        a  list of absolute pathnames of articles arriving between
  117.        ›4mstartdate›24m and ›4menddate›24m (default ``now'').
  118.  
  119.        ›4mAddmissing›24m scans the ›4mhistory›24m  file  and  the  news­article
  120.        tree  to  find  articles that are not in the history file,
  121.        and adds them to the file, rebuilding the ›4mdbz›24m database  to
  122.        match.
  123.  
  124. ›1mFILES›22m
  125.        /usr/lib/news/history   history file
  126.        /usr/lib/news/history.pag›4mdbz›24m database for history file
  127.  
  128.  
  129.  
  130.                            13 Oct 1990                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NEWSMAINT(8)                                         NEWSMAINT(8)
  137.  
  138.  
  139.        /usr/lib/news/history.dir›4mdbz›24m database for history file
  140.        /usr/lib/news/log       current news log
  141.        /usr/lib/news/log.o     previous news log
  142.        /usr/lib/news/errlog    current news­error log
  143.        /usr/lib/news/errlog.o* old news­error logs
  144.        /usr/lib/news/batchlog  current news­batcher log
  145.        /usr/lib/news/batchlog.o*old news­batcher logs
  146.        /usr/spool/news/in.cominginput­spooling area
  147.        /usr/spool/news/out.goingoutput­batching area
  148.        /usr/lib/news/watchtime last time ›4mnewswatch›24m was run
  149.        /usr/lib/news/active    list of current newsgroups
  150.        /usr/lib/news/active.oldbackup copy created by ›4maddgroup›24m and ›4mdelgroup›24m
  151.  
  152. ›1mSEE›22m ›1mALSO›22m
  153.        df(1),  uucp(1), ls(1), ctime(3), getdate(3), hostname(1),
  154.        grep(1),  news(5),  expire(8),   newsbatch(8),   rnews(8),
  155.        newsaux(8)
  156.  
  157. ›1mDIAGNOSTICS›22m
  158.        ›4mLocknews›24m  complains  and exits if it is unable to lock the
  159.        news system; this is typically a matter of  either  inade­
  160.        quate permissions or news activity already in progress.
  161.  
  162.        ›4mAddfeed›24m  looks  for a ›1m/default/›22m line or a line for ›4msite›24m in
  163.        the ›4mbatchparms›24m file, and if none is found, warns the  user
  164.        to create one.
  165.  
  166.        ›4mAddmissing›24m complains and exits if it is unable to lock the
  167.        news system, if ›4mexpire›24m appears to be running, or if  there
  168.        is  not  enough  space for a temporary copy of the ›4mhistory›24m
  169.        file and database.  It also notes the presence of articles
  170.        which  did not have intelligible headers (which are placed
  171.        into history with an entry specifying immediate expiry).
  172.  
  173. ›1mHISTORY›22m
  174.        Written at U of Toronto by Henry Spencer  and  Geoff  Col­
  175.        lyer.
  176.  
  177. ›1mBUGS›22m
  178.        ›4mLocknews›24m is a bit crude.
  179.  
  180.        ›4mDelgroup›24m   does  not  remove  files  or  directories  from
  181.        /usr/spool/news, although it prints a reminder to do so.
  182.  
  183.        The ›1m=›4m›22mname›24m form of ›4maddfeed›24m cannot cope with  continued  ›4msys›24m
  184.        lines.
  185.  
  186.        ›4mAddfeed›24m assumes that attention to the ›4mbatchparms›24m file suf­
  187.        fices to get batching going for a new feed, which is naive
  188.        if  you  are  running  ›4msendbatches›24m  selectively, i.e. with
  189.        arguments.
  190.  
  191.        ›4mAddmissing›24m does not cope properly with articles which  are
  192.        already   in  history  but  with  an  incomplete  list  of
  193.  
  194.  
  195.  
  196.                            13 Oct 1990                          3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. NEWSMAINT(8)                                         NEWSMAINT(8)
  203.  
  204.  
  205.        pathnames; the result is duplicate message­IDs in  history
  206.        until  the article(s) expire, which is relatively harmless
  207.        but may interfere with access to those articles.
  208.  
  209.        Various nuisances can result if the maintenance  utilities
  210.        are  run  as  ›4mroot›24m  rather  than  as the owner of the news
  211.        database.  It's difficult to defend against this.
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                            13 Oct 1990                          4
  263.  
  264.  
  265.